System.Array.Sort 方法 (TKey[], TValue[], IComparer)

方法描述

基于第一个 Array 中的关键字,使用指定的 IComparer 泛型接口,对两个 Array 对象(一个包含关键字,另一个包含对应的项)进行排序。

语法定义(C# System.Array.Sort 方法 (TKey[], TValue[], IComparer) 的用法)

public static void Sort(
	TKey[] keys,
	TValue[] items,
	IComparer comparer
)

参数/返回值

参数值/返回值 参数类型/返回类型 参数描述/返回描述
keys TKey[] 从零开始的一维 Array,它包含要排序的关键字。
items TValue[] 从零开始的一维 Array,其中包含与 keys 中的关键字对应的项;如果为 null,则只对 keys 进行排序。
comparer System-Collections-Generic-IComparer 比较元素时使用的 IComparer 泛型接口实现;如果为 null,则使用每个元素的 IComparable 泛型接口实现。
返回值 void

提示和注释

keys Array 中的每个关键字在 itemsArray 中都有对应项。 当关键字在排序过程中重新定位时,itemsArray 中的对应项也同样重新定位。 因此,itemsArray 根据 keysArray 中对应关键字的排列进行排序。

如果 comparer 为 null,则 keysArray 中的每个关键字均必须实现 IComparable 泛型接口,才能与其他所有关键字进行比较。

如果项数多于键数,您仍可以进行排序,但没有对应的键的项将不会被排序。 如果键数多于项数,您不能进行排序,这样做会引发 ArgumentException。

如果排序不能成功地完成,则结果未定义。

此方法使用 QuickSort 算法。 此实现执行不稳定排序;亦即,如果两元素相等,则其顺序可能不被保留。 相反,稳定排序则会保持相等元素的顺序。

一般情况下,此方法的运算复杂度为 O(n log n),其中 n 是 array 的 Length;最坏的情况下其运算复杂度为 O(n ^ 2)。

System.Array.Sort 方法 (TKey[], TValue[], IComparer)例子

如果您使用 Ildasm.exe(MSIL 反汇编程序) 检查 Microsoft 中间语言 (MSIL),则可以看到正在调用泛型方法。

using System;
using System.Collections.Generic;

public class ReverseComparer: IComparer
{
    public int Compare(string x, string y)
    {
        // Compare y and x in reverse order.
        return y.CompareTo(x);
    }
}

public class Example
{
    public static void Main()
    {
        string[] dinosaurs = {
            "Seismosaurus", 
            "Chasmosaurus", 
            "Coelophysis", 
            "Mamenchisaurus", 
            "Caudipteryx", 
            "Cetiosaurus"  };

        int[] dinosaurSizes = { 40, 5, 3, 22, 1, 18 };

        Console.WriteLine();
        for (int i = 0; i < dinosaurs.Length; i++)
        {
            Console.WriteLine("{0}: up to {1} meters long.", 
                dinosaurs[i], dinosaurSizes[i]);
        }

        Console.WriteLine("\nSort(dinosaurs, dinosaurSizes)");
        Array.Sort(dinosaurs, dinosaurSizes);

        Console.WriteLine();
        for (int i = 0; i < dinosaurs.Length; i++)
        {
            Console.WriteLine("{0}: up to {1} meters long.", 
                dinosaurs[i], dinosaurSizes[i]);
        }

        ReverseComparer rc = new ReverseComparer();

        Console.WriteLine("\nSort(dinosaurs, dinosaurSizes, rc)");
        Array.Sort(dinosaurs, dinosaurSizes, rc);

        Console.WriteLine();
        for (int i = 0; i < dinosaurs.Length; i++)
        {
            Console.WriteLine("{0}: up to {1} meters long.", 
                dinosaurs[i], dinosaurSizes[i]);
        }

        Console.WriteLine("\nSort(dinosaurs, dinosaurSizes, 3, 3)");
        Array.Sort(dinosaurs, dinosaurSizes, 3, 3);

        Console.WriteLine();
        for (int i = 0; i < dinosaurs.Length; i++)
        {
            Console.WriteLine("{0}: up to {1} meters long.", 
                dinosaurs[i], dinosaurSizes[i]);
        }

        Console.WriteLine("\nSort(dinosaurs, dinosaurSizes, 3, 3, rc)");
        Array.Sort(dinosaurs, dinosaurSizes, 3, 3, rc);

        Console.WriteLine();
        for (int i = 0; i < dinosaurs.Length; i++)
        {
            Console.WriteLine("{0}: up to {1} meters long.", 
                dinosaurs[i], dinosaurSizes[i]);
        }
    }
}

/* This code example produces the following output:

Seismosaurus: up to 40 meters long.
Chasmosaurus: up to 5 meters long.
Coelophysis: up to 3 meters long.
Mamenchisaurus: up to 22 meters long.
Caudipteryx: up to 1 meters long.
Cetiosaurus: up to 18 meters long.

Sort(dinosaurs, dinosaurSizes)

Caudipteryx: up to 1 meters long.
Cetiosaurus: up to 18 meters long.
Chasmosaurus: up to 5 meters long.
Coelophysis: up to 3 meters long.
Mamenchisaurus: up to 22 meters long.
Seismosaurus: up to 40 meters long.

Sort(dinosaurs, dinosaurSizes, rc)

Seismosaurus: up to 40 meters long.
Mamenchisaurus: up to 22 meters long.
Coelophysis: up to 3 meters long.
Chasmosaurus: up to 5 meters long.
Cetiosaurus: up to 18 meters long.
Caudipteryx: up to 1 meters long.

Sort(dinosaurs, dinosaurSizes, 3, 3)

Seismosaurus: up to 40 meters long.
Mamenchisaurus: up to 22 meters long.
Coelophysis: up to 3 meters long.
Caudipteryx: up to 1 meters long.
Cetiosaurus: up to 18 meters long.
Chasmosaurus: up to 5 meters long.

Sort(dinosaurs, dinosaurSizes, 3, 3, rc)

Seismosaurus: up to 40 meters long.
Mamenchisaurus: up to 22 meters long.
Coelophysis: up to 3 meters long.
Chasmosaurus: up to 5 meters long.
Cetiosaurus: up to 18 meters long.
Caudipteryx: up to 1 meters long.
 */

异常

异常 异常描述
ArgumentNullException keys 为 null。
ArgumentException
  • items 不是 null,且 keys 的下限与 items 的下限不匹配。
  • items 不是 null,并且 keys 的长度大于 items 的长度。
  • comparer 的实现导致排序时出现错误。 例如,将某个项与其自身进行比较时,comparer 可能不返回 0。
InvalidOperationException comparer 为 null,并且 keysArray 中的一个或多个元素未实现 IComparable 泛型接口。

命名空间

namespace: System

程序集: mscorlib(在 mscorlib.dll 中)

版本信息

.NET Framework 受以下版本支持:4、3.5、3.0、2.0 .NET Framework Client Profile 受以下版本支持:4、3.5 SP1

适用平台

Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008(不支持服务器核心), Windows Server 2008 R2(支持 SP1 或更高版本的服务器核心), Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求。